Release 10.1A: OpenEdge Getting Started:
Application and Integration Services

OpenEdge Adapter for Sonic ESB

The OpenEdge Adapter for Sonic ESB communicates with the SonicMQ Broker and with the AppServer to enable OpenEdge services to receive and process requests from clients. OpenEdge services are actually Progress 4GL Web services that have been deployed (installed) into a Sonic ESB container through the agency of the OpenEdge Adapter for Sonic ESB. For more information on Progress 4GL Web services and how they are created, see Chapter 6, " Web Services in OpenEdge—Architecture and Tools."

Note: For the purpose of exposing an AppServer application service as a Web service, the OpenEdge Adapter for Sonic ESB (and the Sonic ESB where it is installed) serves the same function as the OpenEdge Web Services Adapter (WSA) (and the Java servlet engine (JSE) where it is installed). As an OpenEdge service installed in the Sonic ESB environment, the AppServer application service can also take part in workflow processes managed by the Sonic ESB.

As depicted in Figure 7–6, at run time the OpenEdge Adapter for Sonic ESB receives SOAP messages from the SonicMQ Broker, converts them to 4GL, and sends them to the AppServer to be processed. The adapter then receives 4GL messages from the AppServer, converts them to SOAP, and returns them to the broker.

In addition, for each OpenEdge service, the OpenEdge Adapter for Sonic ESB:

Processes the WSM (or WSD) file.
Optionally generates the WSDL file for either internal (relative to the ESB) or external use.

WSM files

The Web Service Mapping (WSM) file contains the XML-encoded instructions that enable the OpenEdge Adapter for Sonic ESB to process SOAP messages according to the needs of the 4GL application. A WSM file is created for each service using the OpenEdge Open Client Proxy Generator tool (ProxyGen). For more information on ProxyGen and how to create WSM files, see OpenEdge Development: Open Client Introduction and Programming .

In the process of installing an OpenEdge service in the Sonic ESB environment, the OpenEdge Adapter for Sonic ESB takes the WSM file as its primary input. Sonic ESB then converts this file to a service resource that you can edit with a custom OpenEdge service editor (accessed through the Sonic ESB Explorer user interface) to modify its run-time properties.

WSDL files

The Web Services Description Language (WSDL) file is an XML file containing the information required by programmers of client applications that will call the service. It is a standard component widely used in the industry for development of Web service clients. The OpenEdge Service Editor generates the WSDL file as part of the service deployment process. WSDL files are stored as resources in the Sonic ESB and can be viewed and edited with the Sonic Integration Workbench. For more information on the WSDL files generated by the OpenEdge Adapter for Sonic ESB and how Web service clients must use them, see OpenEdge Development: Web Services .